home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / public / tuner / README < prev    next >
Text File  |  1994-08-01  |  5KB  |  128 lines
  1.     Tuner 1.4
  2.     ---------
  3.  
  4. This is tuner version 1.4, a motif-based tuner to accompany the
  5. ethernet radio program, allowing you to select an ethernet radio
  6. station to listen to. It is meant to work with radio 2.0, but will
  7. also work with older releases of radio, although the playlist feature
  8. will not work.
  9.  
  10. "Radio" is a set of programs that allows you to connect an audio
  11. source (radio, CD player) to your Sun, SGI or NeXT workstation and
  12. broadcast low-fi (approximately AM radio quality) audio over a local
  13. area network. Other users can then listen to your broadcasts.
  14.  
  15. Radio is distributed separately, and is posted to comp.sources.unix
  16. around this time. It is also available for FTP access, as file
  17. /pub/radio2.0.tar.Z on host ftp.cwi.nl. This tuner is also available
  18. there, as /pub/tuner1.4.shar.
  19.  
  20. Differences with 1.3
  21. --------------------
  22.  
  23. The only functionality that has been added since tuner 1.3 are the
  24. buttons to start radio and listen to the news.
  25.  
  26. Building tuner
  27. --------------
  28.  
  29. Tuner has been tested on an SGI Iris Indigo running Irix 4.0.2 with
  30. Motif 1.1.
  31.  
  32. Version 1.3 also ran on a Sun Sparcstation running SunOS 4.1 with
  33. Motif 1.0, and I have no reasons to believe this will not work anymore.
  34.  
  35. The Motif 1.0 user interface has some quirks (updates of the
  36. 'playlist' list is an... uhm.... interesting process to watch:-) but
  37. it does work.
  38.  
  39. Before building tuner, the Makefile, customize.h and possibly
  40. Tuner.resources should be edited to reflect you local configuration.
  41.  
  42.   The references to 'anp' need a little explanation. We have a service
  43.   locally where we record the hourly newsbulletin from the radio and
  44.   make it available to anyone at any time through the 'anp' program
  45.   (named after the dutch newsservice). We do not distribute this stuff
  46.   because it is both machine- and country-dependent (we recognize the
  47.   news by doing FFTs on the audio and recognizing the leader tune).
  48.  
  49.   If you want to implement a similar service and make it available
  50.   through tuner the easiest way is to do is is:
  51.   - find some way to put the news in a file every hour,
  52.   - create a script with (roughly) the following contents:
  53.      #!/bin/sh
  54.      playaudio newsfile &
  55.      echo $!
  56.      wait
  57.     where 'playaudio' is your audio player. Then set ANP_COMMAND in
  58.     customize.h to the name of this script. The bit with echo and wait
  59.     is meant to make it possible for tuner to abort the news.
  60.  
  61. In the Makefile, edit MOTIF_INC if you have Motif 1.0 (add option
  62. -DMOTIF1_0) and/or if your motif include files live in a non-standard
  63. place (add option -I<include-path>).
  64.  
  65. Next, add an option -L<lib-path> to the MOTIF_LIB variable if your
  66. motif library (or X library, or Xt library) doesn't live in the
  67. standard library path.
  68.  
  69. Finally, update the RESDIR and BINDIR variables to reflect in which
  70. directories you are going to keep the resource file and the tuner
  71. binary.
  72.  
  73. In the file customize.h you have to edit the DFT_NETS define. It should
  74. be set to all networks on which tuner should look for radio stations.
  75. Edit the RADIO_COMMAND to something that starts radio on your system.
  76. Edit ANP_COMMAND to start the newscast, or remove the definition if
  77. you do not want this feature.
  78.  
  79. You might have to edit Tuner.resources to change the default
  80. appearance of tuner. This will be the case if you use monochrome
  81. machines (tuner will not look very nice on a monochrome machine with
  82. the Tuner.resources file as distributed), if you don't have adobe
  83. fonts or if you want to use a language other than English.
  84.  
  85. You are now ready to 'make' and 'make install' to build and install tuner.
  86.  
  87. Notes
  88. -----
  89.  
  90. Tuner is copyrighted but freely distributable. See the copyright
  91. notice below. If you make changes to tuner I would like to hear from you.
  92.  
  93.     Jack Jansen
  94.     Centrum voor Wiskunde en Informatica
  95.     Kruislaan 413
  96.     1098 SJ  Amsterdam
  97.     the Netherlands
  98.  
  99.     phone:    +31 20 592 4098
  100.     fax:      +31 20 592 4199
  101.     internet: jack@cwi.nl
  102.     X.400:    G=Jack;S=Jansen;O=cwi;P=surf;A=400net;C=nl
  103.  
  104.  
  105. Copyright notice
  106. ----------------
  107.  
  108. Copyright 1991, 1992, 1993 by Stichting Mathematisch Centrum, Amsterdam, The
  109. Netherlands.
  110.  
  111.                         All Rights Reserved
  112.  
  113. Permission to use, copy, modify, and distribute this software and its 
  114. documentation for any purpose and without fee is hereby granted, 
  115. provided that the above copyright notice appear in all copies and that
  116. both that copyright notice and this permission notice appear in 
  117. supporting documentation, and that the names of Stichting Mathematisch
  118. Centrum or CWI not be used in advertising or publicity pertaining to
  119. distribution of the software without specific, written prior permission.
  120.  
  121. STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO
  122. THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
  123. FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE
  124. FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  125. WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  126. ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
  127. OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  128.